home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 41 / Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso / -seriously_amiga- / hardware / scsiquery / scsiquery.readme < prev    next >
Text File  |  1999-04-19  |  8KB  |  235 lines
  1. Short:    Prints internal infos of SCSI devices
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     disk/misc
  5. Version:  1.19
  6. Requires: Os 2.04, a true SCSI-2 device (HD,CD mostly)
  7.  
  8. _____________________________________________________________________________
  9.  
  10. Changes made for 1.19:
  11.  
  12. - Made the defect list format selectable, with autoselect for Iomega.
  13. - SCSIQuery prints now the extended INQUIRY data.
  14. - SCSIQuery detects now automatically whether a device name or a DOS
  15.   device driver is given.
  16. _____________________________________________________________________________
  17.  
  18. Changes made for 1.18:
  19.  
  20. - Added more sanity checks, fixed a possible enforcer hit. Thanks to 
  21.   Gene Heskett for reporting.
  22. - Changed the bad block default format to head/sector addressing rather
  23.   than bytes from index. This avoids trouble with Iomega devices.
  24. _____________________________________________________________________________
  25.  
  26. This tool prints all internal information of a SCSI device it can hold
  27. of, including the mode pages and the bad block lists. This might be 
  28. interesting for developers of SCSI software and hardware.
  29.  
  30. SCSIQuery replaces the older ProbSCSI which doesn't seem to run stable under
  31. certain (and in some sense broken) hardware, like the CyberSCSI device
  32. which doesn't seem to follow the RKRMs on each word. 
  33.  
  34.  
  35. Features:
  36.  
  37.     - Prints the device inquiry status
  38.     - Prints SCSI mode pages by their structure. It knowns most
  39.       HD and CD rom pages, and unknown pages are printed in hex dump.
  40.     - Prints the device capacity.
  41.     - Prints the defect list.
  42.     - Knows some Iomega extensions, most noticable for ZIP and JAZ.    
  43.       However, this is far from being complete due to the strange
  44.       information policy of Iomega.
  45.     - tested on the gvpscsi.device, the oktagon.device and the
  46.       (cyber)scsi.device. Should work on every device that follows
  47.       the RKRMs scsi.device documentations (roughly, at least).
  48.  
  49. To do:
  50.     Quite a lot, actually. However, it doesn't look I'm gonna have a
  51.     lot of time to develop this program further. It currently does what
  52.     it is supposed to do, but could do a lot better.
  53.  
  54.     - A GUI is missing. I'm just to lazy to write one in the current
  55.       state of this program.
  56.     - SCSIQuery doesn't allow to change or save the mode pages.
  57.     - Only mode pages for HD and CD are supported, no scanner/printer/
  58.       floptical and other SCSI device support. More mode pages might
  59.       be added on request.
  60.     - No LOG PAGES support yet.
  61.     - The readme is really a bit unhelpful. This program really lacks
  62.       a full detailed guide. However, lack of time... (-;
  63.  
  64.  
  65. Additional note:
  66.  
  67. Requests about what the output of this program means ARE NOT welcome. The
  68. SCSI-II specifications are available in public and they include all this
  69. information. 
  70.  
  71.  
  72. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  73.  
  74. More SCSI mode page informations. I'm able to implement all official pages
  75. of the SCSI-II specifications since I've a copy of the SCSI specifications,
  76. however, there are more, vendor specific pages I've no idea about. Getting
  77. hold of the Iomega specifications - not the output of the program - 
  78. would really, really help.
  79.  
  80. If you've ANY information about these (not the official SCSI-II pages!) 
  81. additional pages, please, please PLEASE LEMME KNOW!
  82.  
  83. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  84. _________________________________________________________________________________
  85.  
  86. Installation:
  87.  
  88.     Just copy it whereever you want to keep it. Needs nothing more.
  89.  
  90.  
  91. Synopsis:
  92.  
  93. SCSIQuery HANDLER=DEVICE/A,UNIT/N,FLAGS/N,DEFECTLIST/K
  94.  
  95.     
  96.     HANDLER=DEVICE    the name of the DOS handler controlling a SCSI    
  97.             device. DO NOT specify handlers that are not
  98.             linked to SCSI devices, this will either abort
  99.             with an error message in the best case, or crashes
  100.             the system in the worst case. You *HAVE TO* place
  101.             a trailing colon ":", e.g. "ZIP:".
  102.             Alternatively, an exec style device, it *MUST*
  103.             end with ".device", e.g. "omniscsi.device"
  104.  
  105.     UNIT        the unit of the exec device to investigate, required
  106.             if an exec device name was specified.
  107.  
  108.     FLAGS        flags used for opening the specific device;
  109.             defaults to zero and are not required in most cases.
  110.  
  111.     DEFECTLIST    the type of defect list to inquiry from the device.
  112.             Possible defect list specifiers are:
  113.  
  114.         OFF        Do not print a defect list.
  115.         INDEX        Specify defaults as bytes from an index on 
  116.                 the tracks.
  117.         PHYSICAL    Specify defaults as physical head, cylinder
  118.                 and block.
  119.         BLOCK        Specify defects as block offsets from the
  120.                 start of the drive.
  121.         DEFAULT        Use the INDEX method for all drivers except
  122.                 for Iomega devices which use the PHYSICAL
  123.                 type.
  124.  
  125.  
  126. Examples:
  127.  
  128.  
  129. To investigate your system partition, try:
  130.  
  131. SCSIQuery DH0:
  132.  
  133.  
  134. To print information about your CD ROM, try:
  135.  
  136. SCSIQuery CD0:
  137.  
  138.  
  139. To query the SCSI device connected to the "gvpscsi.device", unit 6, try:
  140.  
  141. SCSIQuery gvpscsi.device UNIT=6
  142.  
  143.  
  144. To query the SCSI device connected to the "oktagon.device", unit 0, try:
  145.  
  146. SCSIQuery oktagon.device UNIT=0
  147.  
  148. _____________________________________________________________________________
  149.  
  150. Special thanks goes to Werner Müller for testing. This program was actually
  151. written to help him finding problems in his SCSI configuration.
  152. _____________________________________________________________________________
  153.  
  154.                          The THOR-Software Licence (v2, 24th June 1998)
  155.  
  156.  
  157. This License applies to the computer programs known as "SCSIQuery".
  158. The "Program", below, refers to such program. The "Archive" refers to the 
  159. original and unmodified package of distribution, as prepared by the author 
  160. of the Program. Each licensee is addressed as "you".
  161.  
  162.  
  163.  
  164. The Program and the data in the archive are freely distributable
  165. under the restrictions stated below, but are also Copyright (c)
  166. Thomas Richter.
  167.  
  168. Distribution of the Program, the Archive and the data in the Archive by a
  169. commercial organization without written permission from the author to any
  170. third party is prohibited if any payment is made in connection with such
  171. distribution, whether directly (as in payment for a copy of the Program) or
  172. indirectly (as in payment for some service related to the Program, or
  173. payment for some product or service that includes a copy of the Program
  174. "without charge"; these are only examples, and not an exhaustive enumeration
  175. of prohibited activities).
  176.  
  177.  
  178. However, the following methods of distribution
  179. involving payment shall not in and of themselves be a violation of this
  180. restriction:
  181.  
  182.  
  183. (i) Posting the Program on a public access information storage and
  184. retrieval service for which a fee is received for retrieving information
  185. (such as an on-line service), provided that the fee is not
  186. content-dependent (i.e., the fee would be the same for retrieving the same
  187. volume of information consisting of random data).
  188.  
  189.  
  190. (ii) Distributing the Program on a CD-ROM, provided that
  191.  
  192. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  193. especially this licence agreement;
  194.  
  195. b) the CD-ROM is made available to the public for a nominal fee only,
  196.  
  197. c) a copy of the CD is made available to the author for free except for
  198. shipment costs, and
  199.  
  200. d) provided further that all information on such CD-ROM is redistributable
  201. for non-commercial purposes without charge.
  202.  
  203.  
  204. Redistribution of a modified version of the Archive, the Program or the
  205. contents of the Archive is prohibited in any way, by any organization,
  206. regardless whether commercial or non-commercial. Everything must be kept
  207. together, in original and unmodified form.
  208.  
  209.  
  210.  
  211.  
  212. Limitations.
  213.  
  214.  
  215. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  216. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  217. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  218. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  219. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  220. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  221. SERVICING, REPAIR OR CORRECTION.
  222.  
  223.  
  224. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  225. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  226. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  227.  
  228.  
  229.                                                         Thomas Richter
  230. _____________________________________________________________________________
  231.  
  232. And now, have fun!
  233.  
  234.     Thomas        (April 1999)
  235.